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Assembler Syntax 


Sun Microsystems’ Sun-4 Assembler takes assembly language programs, as 
specified in this document, and produces relocatable object files for processing 
by the Sun-4 link editor. The assembly language described in this document 
corresponds with the SPARC instruction set defined in the SPARC™ Architecture 
Manual, Version 8, is intended for use on Sun-4s and SPARC Stations. 


You should also become familiar with the manual pages as(l), ld{\), cpp{\), 

a.out(5), and the SPARC Architecture Manual. 

The following example illustrates how a short assembly language program might 


* a simple program to copy a string 

* showing correct syntax, delay slots, and use of annul bit. 

* pseudo-operations: .seg, .global, .asciz, .skip 

* synthetic instructions: set, ret, retl, mov, inc, deccc, nop 

* numeric label: 1 

* symbolic substitution: WINDOWSIZE 
*/ 

#include <sun4/asm linkage.h> 


. seg 

"text" 


.global 

_main 


save 

%sp, -WINDOWSIZE, %sp 


set 

str, %o 

! source string 

set 

out, %ol 

! destination location 

call 

_bcopy 


mov 

24, %o2 

! delay slot, length to ' 

ret 

restore 

%o0, 0, %o0 

! return value from main 

.global 

_bcopy 



<» sun 

microsystems 
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2 Sun~4 Assembly Language Reference 


fl: 





inc 

%o0 

! inc from address 


stb 

%o4, [%ol] 

! write to address 


inc 

%ol 

! in the delay slot: inc to address 

_bcopy: 

deccc 

%o2 

! dec count, set condition codes 


bge, a 

lb 

! loop until done 


Idub 

[%o0 ], %o4 

! delay slot, read from address 


retl 


! leaf routine return 


nop 


! delay slot 


. seg 

"data" 


str: 

.asciz 

"this is a sample string" 



. seg 

"bss" 


out: 

. skip 

30 

! reserve 30 bytes 

V 



J 


lA. Syntax Notation In the descriptions of assembly language syntax in this chapter, brackets “[ ]” 

enclose optional items, and the star indicates items to be repeated zero or 
more times. Braces “{ }” enclose alternate item choices, which are separated 

from each other by vertical bare Wherever blanks are allowed, arbitraiy 
numbers of blanks and horizontal tabs may be used. 


The syntax of assembly language lines is: 


f 

[statement [ ; statement]*] [1 comment] 


[ ! comment] 

i___...._____ 

) 


1.5, Statement Syntax The syntax of an assembly language statement is: 


f 


[ label : ] [ instruction ] 


V. 

J 


In the above syntax, label is a symbol name (described below), instruction is an 

encoded pseudo-op, synthetic instruction, or instruction, and comment is any text 

up to the line end. 

1.6. Lexical Features This section describes lexical features of the assembler’s syntax. 
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Chapter 1 — Assembler Syntax 3 


Case Distinction 


Comments 


Numbers 


Strings 


Symbol Names 


Upper and lower case are distinct everywhere, except in the names of special 
symbols (see below), where there is no case distinction. 

A comment is preceded by an exclamation mark; the “ ! ” and all following char¬ 
acters up to the end of the line are ignored. C-style comments with 
are also permitted, and may span multiple lines. 

Decimal, hexadecimal, and octal numeric constants are recognized, and are writ¬ 
ten as in the C language. For floating-point pseudo operations, floating-point 
constants are written with Or or OR (for REAL) followed by a string acceptable 
to atof (3): an optional sign followed by a nonempty string of digits with 
optional decimal point and optional exponent, or followed by a special name, as 
shown below. 

The special names Oman and Orinf represent the special floating-point values 
Not-A-Number and INFinity, respectively. Negative Not-A-Number and Nega¬ 
tive INFinity are specified as Or-nan and Or-inf, respectively. 

NOTE Notice that the names of these floating-point constants begin with a zero, not the 
letter " 0 ” 

Strings may be quoted with either double-quote (") or single-quote {') marks. 
When used in an expression, the numeric value of a string is the numeric value of 
the ASCII representation of its first character. 


The suggested style is to use single quote marks for the ASCII value of a single 
character, and double quote marks for quoted-string op>erands, such as used by 
pseudo-ops. Here is some assembly code in the suggested style: 


f - 



- \ 

add 

%gl^ 'a'K' ,%gl 

! gl + (' a' - ' K' ) —> gl 


. seg 

" data" 



.ascii 

"a string" 



.byte 




V 



.J 


The following escape codes are recognized in strings; they are derived from C: 


\b 

backspace 

\f 

formfeed 

\n 

newline (linefeed) 

\r 

carriage return 

\t 

horizontal tab 

\nnn 

octal value nnn 


The syntax for a symbol name is: 

{ letter 1 _ I $ I • } { letter I _ I $ I • I digit } ^ 

V___. 

Upper-case and lower-case letters are distinct, and the underscore, dollar sign, 
and period are treated as alphabetic characters. 


Asun 
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4 Sun-4 Assembly Language Reference 


Symbol names that begin with L are assumed to be compiler-generated local 
symbols, and, to simplify debugging somewhat, are best avoided in hand-coded 

assembly language routines. 

The symbol “. ” is predefined, and always refers to the address of the beginning 

of the current assembly language statement. 

NOTE By convention, system run-time routine names start with and names from C, 
assembly language and f 7 7 begin with a . 

Labels A label is either a symbol or a single decimal digit(0.. .9). Note that a label is 

immediately followed by a colon. 

Numeric labels may be defined repeatedly in an assembly, whereas normal sym¬ 
bolic labels may be defined only once. 

A numeric label n is referenced after its definition (backward reference) as nb, 

and before its definition (forward reference) as . 

Special Symbols Special symbol names begin with % so as not to conflict with user symbols, and 

include: 


Table 1-1 Special Symbols 


Symbol Object 

Name 

Comment 

general-purpose registers 

%r0 . . 

. %r31 



general-purpose global registers 

%g0 . . 

. %g7 

(same as %r0 .. 

. %r7j 

general-purpose “out” registers 

%o0 . . 

. %o7 

(same as %r8 .. 

. %rl5) 

general-purpose “local” registers 

o 

1 — 1 
a\° 

. %17 

(same as %r 16 . 

.. %r23j 

general-purpose “in” registers 

%i0 .. 

. %i7 

(same as . 

. . %r31) 

stack-pointer register 

%sp 


f%sp = %o6 = 

%14) 

frame-pointer register 

%fp 


(%fp = %i6 = 

%30) 

floating-point registers 

%f0 .. 

. %f31 



floating-point status register 

f S IT 




front of floating-point queue 

%fq 




coprocessor registers 

%c0 . , 

. %c31 



coprocessor status register 

%csr 




coprocessor queue 

%cq 




program status register 

%psr 




trap vector base address register 

% tbir 




window invalid mask 

%wiin 




Y register 





unary operators 

%lo 


(extracts least significant 10 bits) 


%hi 


(extracts most significant 22 bits) 


There is no case distinction in special symbols; therefore using something like 

%PSR is equivalent to %psr. Use of all lower-case is the suggested style. The 

lack of case distinction allows for the use of non-recursive preprocessor 


Asun 

'w microsystems 
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Chapter 1 — Assembler Syntax 5 


substitutions, such as 


f - 

#define psr %PSR 

^_ 

_> 

The special symbols %hi and %lo are true unary operators which can be used in 
any expression, and like other unary operators have higher precedence than 
binary operations. For example: 


%hi a+b = (%hi a)+b 
%lo a+b s (%lo a)+b 


It is a good idea to enclose operands of % 
ambiguity. For example: 

hi or %lo in parentheses to avoid 

f 

%hi(a) + b 




J 


Operators and Expressions The following operators are recognized in constant expressions: 


Binary Operators 

Unary Operators 

+ Integer Addition 

Integer Subtraction 
* Integer Multiplication 

/ Integer Division 

% Modulo 

Exclusive OR 
« Left Shift 

» Right Shift 

& Bitwise AND 

( Bitwise OR 

+ (no effect) 

2’s Complement 
~ I’s Complement 

%lo (see above) 

%hi (see above) 


Note that the modulo operator % must not be immediately followed by a letter or 
digit, to avoid confusion with register names or with %hi or %lo. The modulo 
operator is typically followed by a space or left parenthesis. 

Although the above operators have the same precedence as in the C language, 
parenthesization of expressions is recommended to avoid ambiguity. 


1.7. as Error Messages Messages generated by the assembler are generally self explanatory and give 

sufficient information to allow one to correct a problem. Certain conditions will 
cause the assembler to issue warnings associated with delay slots following Con¬ 
trol Transfer Instructions (CTIs): 

□ set instructions in delay slots 

□ labels in delay slots 

o segments that end in control/transfer instructions 


♦sun 

XT microsystems 
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6 Sun-4 Assembly Language Reference 


These are not necessarily incorrect, but point to places where a problem could 

exist. If you have intentionally written code this way, you can inform the assem¬ 
bler that you know what you are doing by inserting a pseudo-op in a manner 

similar to a C programmer’s using casts. 

The . empty pseudo-operation in a delay slot tells the assembler that the delay 

slot can be empty or contain whatever follows, because you have verified that 
either the code is correct or the content of the delay slot doesn’t matter. Avoid 
using . empty in assembly-language programs just as you would avoid using 
casts in C programs. The . empty pseudo-operation is used only in programs 
written in assembly language; Sun’s compilers don’t generate it. 


#sun 

microsystems 
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Instruction-Set Mapping 


The tables in this chapter describe the relationship between hardware instructions 
of the SPARC architecture, as defined in SPARC Processor Architecture, and the 
instruction set used by Sun Microsystems’ SPARC Assembler. 

2.1. Table Notation The following table describes the notation used in the tables in the rest of the 

chapter to describe the instruction set of the assembler. 


Table 2-1 Notation 


Symbol 

Describes 

Comment 

reg 

%r0 . . . %r31 
%g0 ... %g7 
%o0 ... %o7 

%10 ... %17 

%i0 ... %i7 

(same as %rO...%r7J 
(same as %r8...%rl5J 
(same as %rl6 . . . %r23j 
(same as %r24 . . . %r31j 

freg 

%f0 ... %f31 


creg 

%c0 ... %c31 


value 


(an expression involving at most one relocatable symbol) 

constJS 

value 

(a signed constant which fits in !3 bits) 

const22 

value 

(a constant which fits in 22 bits) 

asi 

value 

(alternate address space identifier; an unsigned 8-bit value) 



Destination register. 



Source register !, source register 2. 

regaddr 

''%s, 

Address formed with register contents only. 

address 

reg + constlS 
reg - const! 3 
const! 3 + reg 

rsl 

constlS 

Address formed from register contents, 
immediate constant, or both. 


#sun 

microsystems 
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8 Sun-4 Assembly Language Reference 


Table 2-1 Notatiorh— Continued 


Symbol 

Describes 

Comment 

reg_or_imm 

constlS 

Value from either a single register, or 
an immediate constant. 


2.2. Integer Instructions The following table outlines the correspondence between SPARC hardware 

integer instructions and SPARC assembly language instructions. The following 
notations are suffixed repeatedly to assembler mnemonics (and in upper case for 

SPARC architecture instruction names): 

sr — status register. 

a — instmctions dealing with alternate space. 
b — byte instmctions. 
h — halfword instmctions. 
d — doubleword instmctions. 

/— referencing floating-point registers, 
c — referencing coprocessor register. 

rd — as a subscript, refers to a destination register in the argument list of an 
instmction. 

rs — as a subscript, refers to a source register in the argument list of an 
instmction. 

NOTE The syntax of individual instructions is designed so that a destination operand (if 

any), which may be either a register or a reference to a memory location, is 
always the last operand in a statement. 

In the table below, curly brackets ({}) mark optional arguments. Square brack¬ 
ets ([]) mark indirection: the contents of the addressed memory location are 
being read from or written to. 

NOTE All Dice and Bf cc instructions, described in the following table, may indicate 
that the annul bit is to be set by appending “, a” to the opcode; e.g. “bgeu, a 
label". 



# >sun 
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Chapter 2 — Instruction-Set Mapping 9 


ADD 

ADDcc 

ADDX 

ADDXcc 


ANDN 

ANDNcc 



CALL 



add 

addcc 

addx 

addxcc 


and 

andcc 

andn 

andncc 


bn{ f a} 

bne{ f a} 
be{,a} 
bg{, a} 
ble{,a] 
bge{,a} 
bl{,a] 
bgu{, a} 
bleu{ f a] 
bcc{,a] 
bcs{ f a} 
bpos{, a} 
bneg{ r a} 
bvc{, a] 
bvs{, a] 
ba{,a] 


call 


cbn(, a} 
cb3 {, a] 
cb2{ , a} 
cb23{,a} 
cbl{,a} 
cbl3{,a} 
cbl2{,a} 
cbl23 {, a] 
cbO{, a] 
cb03{ , a] 
cb02{ , a} 
cb023 {, a} 
cb01{,a} 
cb013{ r a} 
cb012{ f a} 
cba{,a} 


re8,,,rreg_ 

reg^^^^reg^ 

reg^^irreg_ 


reg^^^rreg_ 

^^S,,jrreg_ 

reg^^^,reg_ 

reg^^i,reg_ 


prjmm, reg 
or imm, reg 

- — '-’r 

or imm, reg 

- — ^ r 

orjmm, reg 


orjmm, reg 
or imm, reg 

— n 

orjmm, reg 
prjmm, reg 


Add 

Add and modify icc 
Add with carry 


label{, n} 


label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 

label 





Branch on integer condi¬ 
tion codes 


(branch never) 

(synonym: bnzj 
(synonym: bzj 


(synonym: bgeuj 
(synonym: bluj 


(n = # of out registers used 
as arguments) 


Branch on coprocessor 
condition codes 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 


SPARC 

Mnemonic 

Argument List 

Name 

Comments 

FBfcc 

fbn{, a} 

label 

Branch on floating-point 

(branch never) 


fbu{, a} 

label 

condition codes 



fbg{r a} 

label 




fbug{,a} 

label 




fbl{,a} 

label 




fbul{,a] 

label 




fblg{,a} 

label 




fbne{,a} 

label 




fbe{^ a} 

label 


(synonym: fbz j 


fbue{,a} 

label 




fbge{,a} 

label 




fbuge{, a} 

label 




fble{, a} 

label 




fbule{, a} 

label 




fbo{, a} 

label 




fba{, a} 

label 



FLUSH 

flush 

address 

Instruction cache flush 


JMPL 

jmpl 

address, reg 

rd 



LDSB 

Idsb 

[ address ] , reg ^ 

Load signed byte 


LDSH 

Idsh 

[address] , reg ^ 

Load signed halfword 


LDSTUB 

Idstub 

[address] , reg ^ 

Load-store unsigned byte 


LDUB 

Idub 

[address] , reg ^ 

Load unsigned byte 


LDUH 

Iduh 

[address] r^cg ^ 

Load unsigned halfword 


LD 

Id 

[address] , reg^^ 

Load word 


LDD 

Idd 

[address] , reg ^ 

Load double word 

(reg ^ must be even) 

LDF 

Id 

[address] ,freg 

Load floating-point regis- 





ter 


LDFSR 

Id 

[address] , %f sr 



LDDF 

Idd 

[address] ,freg ^ 

Load double floating-point 


LDC 

Id 

[address] , creg ^ 

Load coprocessor 


LDCSR 

Id 

[address] , %csr 



LDDC 

Idd 

[address] , creg ^ 

Load double coprocessor 


LDSBA 

Idsba 

[ regaddr] asi, reg ^ 

Load signed byte from 





alternate space 


LDSHA 

Idsha 

[ regaddr] asi, reg 



LDUBA 

Idub a 

[regaddr] asi, reg ^ 



LDUHA 

Iduha 

[ regaddr] asi, reg ^ 



LDA 

Ida 

[ regaddr] asi, t'eg^^ 



LDDA 

Idda 

[ regaddr] asi, reg 


(reg must be even) 

rd 

LDSTUBA 

Idstuba 

[ regaddr] asi, reg ^ 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 


SPARC 

Mnemonic 

Argument List 

Name 

Comments 

MULScc 

mulscc 

reg ^, reg_or_imm, reg ^ 

Multiply step (and modify 





icc) 


NOP 

nop 

no operation 


OR 

or 

reg ,reg or imm,reg 

Inclusive or 


ORcc 

orcc 

reg ^, reg_or_Jmm, reg ^ 



ORN 

orn 

reg r^eg or imm,reg 

rsl — — rd 



ORNcc 

orncc 

reg , regjDrJmm, reg ^ 



RDASR 

rd 

%asrn ,reg 

rsl rd 



RDY 

rd 

%Yrreg^^ 


(see synthetic instructions) 

RDPSR 

rd 

%psr,reg^^ 


(see synthetic instructions) 

RDWIM 

rd 

%wim, reg ^ 


(see synthetic instructions) 

RDTBR 

rd 

%thr f reg 

rd 


(see synthetic instructions) 

RESTORE 

restore 

reg ,reg or imm,reg 

rsl rd 


(see synthetic instructions) 

RETT 

rett 

address 

Return from trap 


SAVE 

save 

reg ^reg or imnirreg 

rsl ” rd 


(see synthetic instructions) 

SDIV 

sdiv 

reg rsl, reg_or_imm, reg ^ 

signed divide 


SDIVcc 

sdiv 

reg ,reg or imm,reg 

signed divide and modify 





icc 


SMUL 

smul 

reg^si f reg ^ 

signed multiply 


SMULcc 

smulcc 

reg ,reg or imm,reg 

rsl — — rd 

signed multiply and modify 





icc 


SETHI 

sethi 

const22, reg ^ 

Set high 22 bits of r regis- 





ter 



sethi 

%hi {value) , reg ^ 


(see synthetic instructions) 

SEE 

sll 

regr^i, reg_orJmm, reg^^ 

Shift left logical 


SRE 

srl 

reg rsl r regjDrJmm, reg ^ 

Shift right logical 


SRA 

sra 

reg ,reg or imm,reg 

rsl ^ 

Shift right arithmetic 


STB 

stb 

regaddr, [address] 

Store byte. 

(synonyms: stub, stsbj 

STH 

sth 

regaddr, [address] 


(synonyms: stub, stshj 

ST 

st 

regr^r [address] 



STD 

std 

regr^, [address] 


(reg ^ must be even) 

STF 

St 

freg [address] 



STDF 

std 

fregrdt [address] 



STFSR 

St 

%fsr, [address] 

Store floating-point status 





register 


STDFQ 

std 

%fq, [address] 

Store double floating-point 





queue 


STC 

st 

creg [address] 

Store coprocessor 



♦ sun 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 


SPARC 

Mnemonic Argument List 

Name 

Comments 

STDC 

STCSR 

STDCQ 

std creg^^, [ address ] 

St %csr, [address] 

std %cq, [address] 

Store double coprocessor 

queue 


STBA 

STHA 

STA 

STDA 

stba regaddr, [regaddr]asi 

stha regaddr, [regaddr] asi 

sta reg , [regaddr] asi 

rd r r 

St da [regaddr] asi 

Store byte into alternate 
space 

(synonyms: stub a, 

St sbaj 

(synonyms: stuha, stshaj 

(reg ^ must be even) 

SUB 

SUBcc 

SUBX 

SUBXcc 

S Ub r 

S ub C C r ^^8^^ 

subx reg ^ , regjorjmm, reg ^ 

subxcc reg ,reg or imm.reg 

°rsl — °rd 

Subtract 

Subtract and modify icc 
Subtract with carry 


SWAP 

SWAPA 

s wap [ address ] , reg 

swapa [ regaddr] asi, reg^^ 

Swap memory word 

with register 


Ticc 

t n address 

tne address 

te address 

tg address 

tie address 

t ge address 

11 address 

t gu address 

tleu address 

t lu address 

tgeu address 

tpos address 

tneg address 

tvc address 

tvs address 

t a address 

Trap on integer condition 

code. (See note.) 

(trap never) 

(synonym: tnz) 

(synonym: t z ) 

(synonym: tccj 
(synonym: tcsj 

(synonym: tj 


taddcc reg ,reg or imm,reg 

°rsr — °rd 

tsubcc reg ,reg or imm,reg ^ 

taddcctv reg^ ^ , reg_or_mm, reg^^ 

t s ub c c t V reg ^ , regjorjmm, reg ^ 

Tagged add and modify icc 

Tagged add and modify icc 
and trap on overflow 


UDIV 

UDIVcc 

u di V , regjorJmm, reg^^ 

u di Vc c f f ^^8^^ 

unsigned divide 
unsigned divide and 

modify icc 


UMUL 

umul reg , reg or imm, reg ^ 

°rsl — — rd 

unsigned multiply 



Asun 

microsystems 


Revision A of 27 March, 1990 








Chapter 2 — Instruction-Set Mapping 13 


Table 2-2 SPARC to Assembly Language Mapping — Continued 


SPARC 

Mnemonic Argument List 

Name 

Comments 

UMULcc 

umulcc reg rreg or imm,reg 

rsJ — — 

unsigned multiply and 
modify icc 


UNIMP 

unimp constll 

Unimplemented instruction 


WRASR 

WRY 

WRPSR 

WRWIM 

WRTBR 

wr reg or imm, %asr/t 

— — rsl 

wr reg^ ^, reg_or_imm, % y 

wr reg r or zmw, %psr 

rsl , 

wr reg reg_orj.mm, 

wr reg ,reg or imm, ^thr 

rsl — — 


(see synthetic instructions) 
(see synthetic instructions) 
(see synthetic instructions) 
(see synthetic instructions) 

XNOR 

XNORcc 

xnor reg ^, regjorjmm, reg ^ 

xnorcc reg ,reg or imm, reg 

rsl — — 

Exclusive nor 


XOR 

XORcc 

X 0 r rsl ' r 

X o r c c reg ^, reg_or_imm, reg ^ 

Exclusive or 



NOTE Trap numbers 16-31 are available for use by the user, and will not be usurped by 
Sun. Currently-defined trap numbers are those defined in 
/ usr/include/ sun4/trap. h, as follows: 


0x00 

ST_ 

_SYSCALL 

0x01 

ST_ 

_BREAKPOINT 

0x02 

ST_ 

_DIV0 

0x03 

ST_ 

_FLUSH_WINDOWS 

0x04 

ST_ 

_CLEAN_WINDOWS 

0x05 

ST_ 

_RANGE_CHECK 

0x06 

ST_ 

_FIX_ALIGN 

0x07 

ST 

INT OVERFLOW 


2.3. Floating-Point In the table below, the types of numbers being manipulated by an instruction are 

Instructions denoted by the following lowercase letters: 

i — integer 

— single 

d — double 

q — quad 

In some cases where more than numeric type is involved, each instruction in a 
group is described. Otherwise, only the first member of a group is described. 
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SPARC 


Mnemonic 


Argument List 


Description 


FiTOs 

FiTOd 

FiTOq 

fit os 

fitod 

fitoq 

Convert integer to single. 

Convert integer to double. 

Convert integer to quad. 

FsTOi 

FdTOi 

FqTOi 

fstoi 

fdtoi ^^^Kd 

fqtoi ^^^rd 

Convert single to integer. 

Convert double to integer. 

Convert quad to integer. 

m 

fstod freg freg ^ 

fstoq f^^ 8 rs 2 ' 

Convert single to double. 

Convert single to quad. 

FdTOs 

FdTOq 

fdtos 

fdtoq ^^^Kd 

Convert double to single. 

Convert double to quad. 

FqTOd 

FqTOs 

fqtod 

fqtos f^^Kd 

Convert quad to double. 

Convert quad to single. 

FMOVs 

FNEGs 

FABSs 

fmovs freg , freg 

rs2 rd 

fnegs 

fabss 

Move 

Negate 

Absolute value 



^^^^^^^^^^^lllllllllllllllllllllll^^ 

FADDs 

FADDd 

FADDq 

f adds freg^^^ , , freg^^ 

faddd ^^^^rd 

faddq ^^^Kd 

Add 

FSUBs 

FSUBd 

FSUBq 

f S Ub S 

fsubd freg , freg , freg 

■’ ^rsl' f °rs2' \ °rd 

fSUbX 

Subtract 

FMULs 

FMULd 

FMULq 

f mu 1 s 

f mu 1 d ^ f^^^rs 2 ' f^^^rd 

fmulq 

Multiply 

FdMULq 

FsMULd 

f mu 1 q r 

fsmuld fi^s’^rs 2 '^^%d 

Multiply double to quad. 

Multiply single to double. 

FDIVs 

FDIVd 

FDIVq 

f di V S ' f^^^rd 

f divd freg' , freg \, freg' 

^ . j.rsl rs2 rd 

f dl Vq ^ 

Divide 

FCMPs 

FCMPd 

FCMPq 

fcmps fr^ 8^^2 

f cmpd ' ^^^^rs 2 

fcmpq freglj' ^^ 8^2 

Compare 



Revision A of 27 March, 1990 































Chapter 2 — Instruction-Set Mapping 15 


Table 2-3 Floating-point Instructions — Continued 


SPARC 

Mnemonic Argument List 

Description 

FCMPEs 

FCMPEd 

FCMPEq 

fcmpes 

fcmped fregl^, freg^ 

fcmpeq 

Compare, Generate exception if unordered. 


2.4. Coprocessor 

Instructions 


All cpopn instructions take aU operands from and return all results to coproces¬ 
sor registers. The data types supported by the coprocessor are coprocessor- 
dependent. Operand alignment is coprocessor-dependent. 

If the EC field of the PSR is 0, or if no coprocessor is present, a cpopn instruc¬ 
tion causes a cp_disabled trap. 

The conditions causing a cp_exception trap are coprocessor-dependent. 

NOTE A non- cpop/i (non-coprocessor-operate) instruction must be executed between 
a cpop2 instruction and a subsequent cbccc instruction. 


Table 2-4 Coprocessor Instructions 


SPARC 

Mnemonic Argument List 

Name 

Comments 

CPopl 

CPop2 

cpopl opd,reg^^^,reg^^^,reg^^ 

cpop2 opd, reg^^^, reg^^^, reg^^ 

Coprocessor operation 
Coprocessor operation 

(may modify ccc’s) 


2.5. Synthetic Instructions This section describes the mapping of synthetic instructions to hardware instruc¬ 
tions. 


Table 2-5 Synthetic Instruction to Hardware Instruction Mapping 


Synthetic Instruction 

Hardware Equivalent(s) 

Comment 

cmp 


subcc 

. reg j, reg_or_Jmm ,%g0 

(compare) 

jmp 

address 

jmpl 

address, %g0 


call 

reg_or_imm 

jmpl 

regjorjmm ,%ol 


tst 


orcc 

reg^^^, %g0, %g0 

(test) 

ret 

retl 

1—1 f—1 

%i7+8,%g0 
%o7+8,%g0 

(return from subroutine) 

(return from leaf subroutine) 

restore 

save 

restore 

save 

%g0 , %g0 , %g0 
%g0 , %g0 , %g0 

(trivial restore) 

(trivial save) 

Warning: trivial save 
should only be used in kernel 
code! 

set 

value, reg^^ 

or 

value, reg^^ 

(if-4096 < value <4095) 
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Synthetic Instruction 


rdware Inst 


Hardware Equivalents) 


ed 


Comment 



me 

inc 

inccc 


dec 

decce 


bt St 

bset 

bclr 

btog 






constlS, reg 

constl3,reg 


constlS f reg 


de c c c const] 3, reg 



reg_or_imm, reg 
reg_or_imm, reg 
reg_or_imm, reg 
regjorjmm, reg 


address] 


address] 

address] 


sethi 

or 

%hi (value) , reg^j 

%lo {value) , reg^^ 

xnor 

reg^^^.%g0,reg^^ 

xnor 

reg^^,%g0,reg^^ 

sub 


sub 

%g0,reg^^,reg^^ 

add 

reg^,1, reg 

add 

reg , const! 3, reg 

rd rd 

addcc 

reg^^,l,reg^^ 

addcc 

reg , const! 3,reg 

rd rd 

sub 

reg^^,l,reg^ 

sub 

reg^^, constI3,reg^ 

subcc 

reg[^,l,reg^^ 

subcc 

reg const! 3, reg ^ 

andcc 

reg ,reg or imm,%g0 

or 

reg , reg or imm, reg 

andn 

reg^^r reg_orJmm, reg^^ 

xor 

reg regjor_imm, reg ^ 

or 

%g0, %g0, 

stb 

%g0, [address] 

sth 

%g0, [address] 

st 

%g0 f [address] 


mov 

reg_or_imm 


mov 



mov 

%psr , reg 

rsl 


mov 

%wim, reg 

rsl 


mov 

%tbr , reg 

, rsl 


mov 

reg_or_imm , 

%y 

mov 

reg or imm. 

%psr 

mov 

regj)r_imm, 

%wim 

mov 

reg_or_imm ^ 

%tbr 



(two’s complement) 
(two’s complement) 



set icc) 


(decrement by 1) 

(decrement by constl3) 
(decrement by 1 and set icc) 

(decrement by const!3 and 
seticc) 



(clear(zero) register) 
(clear byte) 
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2.6. Leaf Procedures Leaf procedures are the outermost routines on the tree of a program, as a tree’s 

leaf is at the end of a stem on the branch of a tree. 

Some leaf procedures can be made to operate without their own register window 
or stack frame, using their caller’s instead. Such a leaf procedure is called an 
optimized leaf procedure. This can be done when the candidate procedure 
meets all of the following conditions: 

□ it contains no CALLS or JMPLs to other procedures 

□ it contains no references to % sp, except in its SAVE instruction 

□ it contains no references to % f p 

□ it refers to, or can be made to refer to, no more than 8 of the 32 integer regis¬ 
ters, inclusive of %o7, the “return address”. 

If a procedure conforms to all of the above conditions, it can be made to operate 
using its caller’s stack frame and registers an optimization that saves both time 
and space. When optimized, the procedure may only safely use registers which 
its caller already assumes to be volatile across a procedure call: %o0 ... %o5, 
%o7, and %gl. This may be expanded to registers %gl ... %g7 if SPARC ABI 
compliance isn’t required. 

Leaf routines are most useful when they prevent expensive window 
overflow/underflow situations, saving many tens of cycles each. 
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Pseudo-Operations 


The following pseudo-operations are supported by the Sun-4 assembler: 


Table A-1 List of Pseudo-Operations 


Mnemonic 

Argument(s) 

Description 

. alias 


Turns off preceding . noalias. (Compiler-generated 
only.) 

.noalias 

%regl, %reg2 

%regl and %reg2 will not alias each other (point to the 
same destination) until a . alias is issued. (Compiler¬ 
generated only.) 

,ascii 

"string" [, "string"] * ' 

Generates the given sequence(s) of ASCII characters. 

.asciz 

"string" [ f "string"] * 

Generates the given sequence(s) of ASCII characters, with 
each string followed by a null byte. 

. optim 

"string" 

Any optimization that can also be given as a flag in the com¬ 
mand line, such as -0[n] with n = {0,1,2,3}. (Compiler¬ 
generated only.) 

. seg 

"string" 

Changes the current segment to the one named, and sets the 
location counter to the location of the next available byte in 
that segment. The default segment at the beginning of 
assembly is text. Currently, only segments text, data, 
datal, and bss are supported. 

. skip 

n 

Increments the location counter by n, which allocates n bytes 
of empty space in the current segment. 

. align 

boundary 

Aligns the location counter on a O-mod-boundary boundary; 
boundary may be 1 (which has no effect), 2, 4, or 8. 

.byte 

Sbitval [ , Sbitval ] * 

Generates (a sequence of) initialized bytes in the current seg¬ 
ment. 

. half 

16bitval [ f 16bitval] * 

Generates (a sequence of) initialized halfwords in the current 
segment. The location counter must already be aligned on a 
halfword boundary (use .align 2). 
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Table A-1 List of Pseudo-Operations — Continued 


Mnemonic 

Argument(s) 

Description 

. word 

32bitval [ ,32bitval] * 

Generates (a sequence of) initialized words in the current 
segment. The location counter must already be aligned on a 
word boundary (use .align 4), 

.single 

Orfloatval [ , 0 rfloatval ] * 

Generates (a sequence of) initialized single-precision 
floating-point values in the current segment. The location 
counter must already be aligned on a word boundary (use 

.align 4). 

.double 

Orfloatval [, 0rfloatval] * 

Generates (a sequence of) initialized double-precision 

floating-point values in the current segment. The location 
counter must already be aligned on a doubleword boundary 

(use . align 8). 

. quad 

Qvfloatval [ , 0 rfloatval ] * 

Generates (a sequence of) initialized quad-precision 
floating-point values in the current segment (. quad 
currendy generates quad-precision values with only double¬ 
precision significance). The location counter must already 
be aligned on a doubleword boundary (use . align 8 ). 

. global 

symbol_name [, symbol name]* 

Marks the (list of) user symbols as “global”. Note that when 
a symbol is both declared to be global and defined (±at is, 
used as a label, used as the left operand of an = pseudo-op, 
or used as the first operand of a . reserve pseudo-op) in 
the same module, the . global must appear before the 
definition. 

. common 

symbol_name, size [ , ^'segment'' ] 

Declares the name and size (in bytes) of a FORTRAN-style 
COMMON area. If "segment" is ’’bss” or not specified, then 
the common area will appear in either the bss or the data 
segment, depending on how symboljiame is defined else¬ 
where. These are the only choices currently supported. 

.reserve 

symboljiame f size 

[, segment" [ ^ boundary] ] 

Defines symbol symboljiame, and reserves size bytes of 

space for it in segment segment (optionally aligned on a 
boundary-bytQ address boundary). This is equivalent to; 

.seg "segment" 

[.align boundary] 

symboljiame'. .skip size 

.seg " < previous segment> " 

If "segment" is not specified, space is reserved in the 
current segment. 

. empty 


Used in the delay slot of a Control Transfer Instruction 
(CTI), this suppresses assembler complaints about the next 
instruction’s presence in a delay slot. Some instructions 

should not be in the delay slot of a CTI. See the SPARC 
Architecture Manual for details. 
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Table A-1 List of Pseudo-Operations — Continued 


Mnemonic 


Description 

.proc 

n 

Signals the beginning of a “procedure” (unit of optimization) 
to the peephole optimizer in the Sun-4 assembler; n specifies 
which registers will contain useful information upon return 
from the procedure, as follows: 

0 no return value 

6 return value in % f 0 

7 return value in %f 0 and %f 1 
(other) return value in %i0 (caller’s %o0) 

The pseudo-operation . proc may be produced by code 
generators for higher-level languages. See note below. 

.stabs 

"string", const4, 0, constl6, const32 

Inserts a symbol table entiy consisting of "string", followed 
by a 4-bit constant const4, a literal zero, a 16-bit constant 
constlS, and a 32-bit constant const32. Used by Sun com¬ 
pilers only to pass information through the object file to 
symbolic debuggers. 

.stabn 

const4, 0, constl6, const32 

Inserts a symbol table entry consisting of a 4-bit numeric 
entry const4, followed by a literal zero, a 16-bit constant 
constlS, and a 32-bit constant const32. Used by Sun com¬ 
pilers only to pass line-number information through the 
object file to symbolic debuggers. 

. stabd 

const4, 0, constl6 

Inserts a symbol-table entry consisting of a 4-bit numeric 
entry const4, followed by a literal zero and a 16-bit constant 
const! 6 . Used by Sun compilers only to pass location- 
counter information through the object file to symbolic 
debuggers. 

= 

symbol name = constant expression 

Assigns the value of constantjexpression to symboljiame. 


NOTE 


Since peephole optimization is not performed on hand-written assembly- 
language code, there is no need for . proc statements in such code. 
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B 

The Sun-4 Assembler 


You invoke as as follows: 

as [options] [inputfile] . . . 

s_ y 




"X 


as translates the assembly language source files, inputfile into an executable 
object file, objfile. The Sun-4 assembler recognizes the filename argument as 
the standard input. 

All undefined symbols in the assembly are treated as global. 

The Sun-4 assembler supports macros, #include files, and symbolic substitu¬ 
tion through use of the C preprocessor cpp. The assembler invokes the prepro¬ 
cessor before assembly begins if it has been specified from the command line as 
an option (see -P below). 


B.l. as Options -L Save defined labels beginning with an L, which are normally discarded to 

save space in the resultant symbol table. The compilers generate many such 
temporary labels. 

-R Make the initialized data segment read-only by concatenating it to the text 
segment. 

~o objfile 

The next argument is taken as the name of the object file to be produced. If 
the -o flag isn’t used, the object file is named a. out. 

-P Run cpp, the C preprocessor, on the files being assembled. The preproces¬ 
sor is mn separately on each input file, not on their concatenation. The 
preprocessor output is passed to the assembler. 


k Generate position-independent code as required by 


f - 


N 


cc -pic/“PIC 




J 


WARNING Don’t apply the -k flag to hand-coded assembler programs unless they are 

written to be position-independent. 
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-Ipath 

-Dname 

-Dname=def 

-XJname 

When -P is in effect, these options are passed to the cpp preprocessor, 
without interpretation by as. Otherwise, they are ignored. 

"0[«] 

Enable peephole optimization corresponding to optimization level n (1 if n is 

not specified) of the Sun high-level language compilers. This option can be 
used safely only when assembling code produced by a Sun compiler. 

-S[C] 

Produce a disassembly of the emitted code to the standard output. This is 

most useful in combination with the -0 option, to review optimized code. 
Adding the character C to the option prevents comment lines from appearing 

in the output. 
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